home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
United Public Domain Gold 4
/
United Public Domain Gold 4.iso
/
scope
/
sc076.dms
/
sc076.adf
/
DirUtil
/
duIII_HR.doc
< prev
next >
Wrap
Text File
|
1989-08-07
|
79KB
|
1,643 lines
DirUtil III Plus HR
File Management Utility for the Commodore Amiga
Copyright 1987-89 Nathan Barber
Program Release Date April 6, 1989
Documentation Release Date April 6, 1989
DirUtil III Plus HR is Copyright 1987-89 by Nathan Barber and is NOT in
the Public Domain. However, the author hereby releases the included
demo version of the program and this documentation for distribution
under the conditions described in the following paragraphs:
DirUtil III Plus HR MUST NOT be distributed unless the ENTIRE dis-
tribution package is made available as one unit.
For information regarding enhancements or other questions, you may also
contact me on GEnie as NBARBER. I also run The AMIGA ADVANTAGE BBS as
FidoNet node 1:366/3. The BBS is your quickest way to get support and
find out about new versions of DirUtil. The BBS runs 24 hours a day, 7
days a week at 38400 BPS with the Courier HST 14.4 KBPS modem and 202
megabytes of hard drive storage. The phone number is (904)-863-8697.
This program is distributed as a demo. If you use and like the demo of
this program and wish to receive the fully operational version, send
$25 in United States currency to the following address:
Nathan Barber
227 Chateaugay St. NW
Fort Walton Beach FL 32548
With the first $25 of your payment, you will receive the latest version
of the program and a personal demo version that you may freely dis-
tribute in order to collect commission bonuses (see below). Amiga User
Groups are invited to inquire about bulk distribution of the program at
reduced rates. Any funds remaining after the initial fee will be put
towards the purchase of enhanced versions of the program as they become
available at the rate of $10.00 each. I will supply the blank disk as
a bonus for advance payment of at least one updated version at the time
of initial purchase.
If you wish to have a change made to the program, enclose its de-
scription with your payment and I will try to add it to your copy prior
to shipping. Bugs (none currently known) reported prior to the release
of an feature enhanced version will be fixed for registered owners of
DirUtil III Plus HR for the cost of shipping and materials. Normal
enhancement updates are available for $10.00 and a blank, formatted
disk sent to the address above ($11.50 with no disk).
DirUtil III Plus HR will perform very closely to what is described in
this documentation. However, because of the nature of the program, the
author cannot assume responsibility for any lost time and/or profits or
claims of fitness for a particular purpose resulting from the use of
the program.
Commission Sales:
----------------
The following policy supercedes all other commission offers previously
extended to Amiga User Groups and individuals.
After registering your copy of the program, the disk you receive will
contain a personal demo version of the program with your serial number
prepended with the letter "D". You may distribute your personal demo
copy through any other channel except as noted in the following
paragraph. This includes bundling the demo version of the program
Page 2
along with the documentation and any other files designated as freely-
redistributable (see ReadMeFirst.doc for the listing). Commissions are
paid as credits towards future updates unless otherwise requested. An
update credit of $5.00 will be awarded for each copy of DirUtil III
Plus HR that is registered using the serial number contained in your
personal demo. It is VERY important that you make sure that persons
registering a copy distributed by you include their serial numbers as
no credit can be given without this number. Cash credits will be given
ONLY if requested in writing at 50% of the current credit balance in
your account. Program updates will be mailed automatically when your
account reaches $10 of credit if an enhanced version of the program is
available. Persons wishing cash payment should address a letter to me
informing me of their desires. Cash payments will be sent out every
three months (approximately) or when the cash balance reaches $50.
Restrictions on Distribution:
----------------------------
DirUtil III Plus HR, its documentation, support programs, and all asso-
ciated works MAY NOT be distributed through the following entities
without prior written permission of the author. Furthermore, all
previous versions of this program written by Nathan Barber and col-
lectively known as DirUtil III and DirUtil III Plus must be removed and
destroyed if any part of this package, or any collection of files
containing this package is available from the same source as this
package.
DirUtil III Plus HR (demo version) must not be distributed to:
1. Any person in the employ of Random Access Computers in Fort Walton
Beach Florida, nor to the business itself.
2. Any person in the employ of Oscar's Computers in Okaloosa County,
Florida, nor to the business itself.
3. Any other business, organization, or computer Bulletin Board
Service in Florida having one of the following area code and
prefix combinations:
904-862 904-863 904-837 904-243 904-244 904-581
904-664 904-651 904-678 904-897 904-729 904-939
904-267
4. The General Electric Network for Information Exchange (GENIE)
EXCEPT for releases uploaded by NBARBER.
These restrictions are to allow a limited beta test area free from
prior versions. Item 4 is included as this is the national network that
will have the most current version and will be handled by myself.
System Requirements:
-------------------
DirUtil III Plus HR requires any Amiga with 512K of memory, one disk
drive, and Kickstart 1.2 or higher. Two disk drives are highly
recommended and certain commands may require more than 512K of memory
ie. SHOWING large picture files.
Page 3
Introduction:
------------
DirUtil III Plus HR and its predecessors have been in development since
March 1987. DirUtil III Plus HR is being "marketed" as a play before
you pay product with a functional demo version of the program being
distributed to unregistered owners. I must say that I am quite pleased
with all the people who have supported and who continue to support the
product and have been willing to bear with me as I make improvements to
the program. DirUtil III Plus HR has now evolved into a multi windowed
program which includes many user suggested enhancements in the hope
that it will make the Amiga a better place to live and play. I plan on
releasing a new version with user suggested improvements approximately
every two months or when I have received ten user requested improve-
ments.
Features of DirUtil III Plus HR:
-------------------------------
DirUtil III Plus HR was made to be a replacement for the AmigaDOS Work-
Bench and CLI interfaces and an alternative to the other file manage-
ment systems now on the market. DirUtil III Plus HR encompasses the
best features of both Workbench and CLI and consumes little memory or
disk space. DirUtil III Plus HR also provides many features not
available or tedious to perform in the normal AmigaDOS environment.
DirUtil contains over 100 functions with variations including user
definable gadgets.
DirUtil is not limited to the preset devices that some programmer
thought up. The program automatically reads YOUR devices upon startup
AND updates them as you work.
With DirUtil, you can delete 90% of the commands in your C: and
SYS:system/ directories, thereby freeing valuable space on your disks.
Unlike most other file management programs, DirUtil contains all the
code you need to do normal disk functions such as COPY, DELETE,
DISKCOPY (with multiple copy ability), FORMAT, SHOW and PLAY.
DirUtil is the ONLY file management program that will show full
overscan pictures successfully and allow scrolling of those pictures.
DirUtil is a viable hard disk backup program when the program's
powerful file selection and archiving features are used.
Known Problems beyond the control of DirUtil III Plus HR:
--------------------------------------------------------
Some older device drivers such as VDK:, do not support setting a
filedate after a file is created. This causes DirUtil to sometimes
fail to set the datestamp on a file it has just copied. If this
happens, just select the file with the bad date (clicking the DATE
gadget will show you the files to select), then hit the RIGHT mouse
button on FIXOBJ.
The Amiga Workbench has a very poor and inconsistent interface to
AmigaDOS. It does not honor the DOS path command in a predictable way
Page 4
and does not support the setting of a current directory without the use
of the DOS CD command. Consequently, the DOS batch file commands
listed under the description of the RUN command are practically useless
if DirUtil is invoked from WorkBench. If you have only one drive and
are trying to run DirUtil strictly from WorkBench, be prepared for a
lot of disk swapping when using the RUN and EXEC commands.
Large scrollable pictures produced with Express Paint from PAR Software
have been reported to cause a crash when viewed from DirUtil. As I do
not have this software, proper handling of these pictures might be a
long time in coming. The maximum size picture thus far shown
successfully shown is 768x480.
Some of the newer "input enhancing" programs such as MachMouse try to
put their own little windows (namely clocks) on the frontmost screen of
the system. DirUtil does not appreciate this in the least and some
functions will not work if there are more windows on the screen than
DirUtil is expecting to find.
IMPORTANT TRACKING INFORMATION:
------------------------------
The copy of DirUtil you received contains a serial number. You can
view the serial number and version number by pressing the key com-
bination ALT-SHIFT-CONTROL. This serial number is used to track
distribution of the program and to provide me with the internal version
number of the program for update purposes. When you register your copy
of DirUtil, include the serial number and version number of the copy
you are registering. This will enable me to pay commissions as
outlined above.
Page 5
Instructions:
Workbench Startup: Click on the DirUtil III Plus HR icon. The
program will load and open a small window on the Workbench screen
as well as its own screen. DirUtil will then load the filelists
from the default device specified in the "Drive" field that is
set from the program EDITCONFIG.
CLI Startup: Type "du" or "run du" (no quotes) to start the
program. A slightly larger stack that the default may be needed
if running the program on a hard disk with many subdirectories.
DirUtil will then load the filelists from the default device if
it is known, otherwise it will default to the drive that you set
in the EDITCONFIG program. A single command line option may now
be used when starting DirUtil from the CLI. DU <diskname> will
start DirUtil with <diskname> as the default directory. IE du
dh2: will start with dh2: as default drive. I/O redirection is
NOT SUPPORTED.
NOTE: The small window that opens on the Workbench screen while
DirUtil is running may not close when the program is exited. If
this happens, it means that another program has "adopted" that
window as its own. The window will close when all programs using
it have closed.
THE DISPLAY WINDOWS: DirUtil opens its own 640x400 four color
interlaced Intuition screen during operation. If you do not like
the interlaced mode of operation, or need to save memory, hitting
SHIFT-ESC will toggle DirUtil into a non-interlaced mode. The
title bar of the largest window on this screen has a display of
"F: xxxxxxx C: xxxxxxxx". The number after the "F:" is the
amount of FAST ram you have available in your Amiga. The number
after the "C:" is the amount of CHIP ram you have available in
your Amiga. The CHIP ram number is the most important as the
Amiga does not perform well when CHIP ram is extremely low. Just
above the Intuition window front/back gadgets on the upper right
is a one pixel tall screen front to back gadget for moving the
DirUtil screen. The majority of the rest of this window contains
the filenames and subdirectories associated with the "S"ource and
"D"estination directories. You may manually change the "S" and
"D" directories by entering a new name in the string gadgets just
above this file display. Above the "S" and "D" gadgets are two
lines used for status information. The two slider gadgets
running down the middle of the screen are used to position the
file display window. The second window, labeled "Function
Window", contains all the gadgets that control what functions
will be done to the highlighted files and/or subdirectories.
This window may be dragged or moved to the back to of the large
window to allow more filenames to be displayed. Also, hitting
ALT-ESC will resize this window to show just the built-in DirUtil
functions (useful for use in non-interlaced mode).
DirUtil can be "iconified" IE reduced to a small Workbench
window, by hitting CTRL-ESC. Clicking the RIGHT mouse button on
the small window created will bring back the normal screen. This
change can also be made by clicking the RIGHT mouse button on
CHANGE.
Page 6
To select/deselect a directory entry, click on its name in the
file window with the left mouse button. Click on one of the
gadgets to take the selected action on the selected names.
To enter a subdirectory, click on its name with the RIGHT mouse
button. NOTE: in order for any function using the RIGHT mouse
button to function, one of the two DirUtil windows must be
active. To automate this requirement, I highly recommend either
DMouse, MachMouse, or QMouse (all available on many Amiga BBS'
around the country).
If you invoke a function that you really did not mean to invoke,
click anywhere in the DirUtil screen with the LEFT mouse button
to abort the operation. You will be asked if you really want to
abort the next time DirUtil checks the status of the mouse. The
mouse is checked before any operation that would write to a disk
and periodically while DirUtil is passively acting on a disk.
Any operation can be aborted, even reading the directory of a
disk.
If you hit and drag either of the slider gadgets, the filenames
will scroll in real time with the movement of the gadget.
The two file windows are treated on an equal basis. Either may
be the "S"ource or "D"estination directory. To switch between
them, just click on the half of the screen containing the window.
You will see the highlighting change and the letters "S" and "D"
change places.
The string gadgets at the top of the DirUtil window are:
S: The source directory.
D: The destination directory.
Normally these two gadgets contain the name of the current
directory that is being manipulated. They are also used to
specify the output directory in certain circumstances. Also,
they are used when entering wildcard specifications (ex-
plained below).
Device Gadgets:
The first two rows of gadgets are reserved for the first
eight file system devices that you have in your system.
These gadgets will always include the disk device from which
the program was booted as well as the PAR: and SER: devices.
DirUtil automatically fills these in alphabetical order when
the program is first booted. If you have less than eight
devices, the remainder of these gadgets will remain blank and
not used. If you have more than eight devices, any unused
user gadgets will be filled with the overflow. If DirUtil
must use this "overflow" area, the gadget text will be
prefixed with the '@' symbol to signify a temporary allo-
cation. Such temporary device gadgets will not be saved upon
exiting the program. DirUtil can update this listing at any
time with a command from you (see USER GADGET descriptions)
and also updates the listing after any operation that may
cause a new device to become mounted and active. Clicking
the left button on one of these gadgets sets the "S"ource di-
Page 7
rectory to the root of the selected device and reads the
filelist of that device if possible. Clicking the RIGHT
mouse button on these gadgets sets the "D"estination gadget
to the root of the selected device and reads its filelist if
possible. While reading the filelist of a disk, DirUtil
might bring up the prompt "Directory Loop - Continue?". This
means that the current filelist has over 256 entries in it
and DirUtil is warning you that your disk directory might be
damaged in such a way as to eventually hang the machine if
processing is continued. If you are not sure of the contents
of the directory you are reading, it is good procedure to
click "ABORT" and see what DirUtil has read so far. There
are many valid situations in which a directory can have more
than 256 proper entries. If you know this to be the case,
feel free to click "CONTINUE" and proceed. If you click
"CONTINUE" and the directory really is in a loop, you will
have to click the left mouse button to abort the filelist
scan operation. Since DirUtil is only limited by available
memory as to the number of filenames it can process, you run
the risk of running out of memory if a directory loop is
allowed to continue forever.
USING WILDCARDS
---------------
DirUtil is capable of matching groups of files using the
technique called "wildcarding". In simple terms, if DirUtil
sees the "*" or the "?" characters in the name of the
directory that you are requesting, it will only list those
names that match according to the following rules:
"?" matches any single character.
"*" matches any number of characters
starting with the "*" and continuing
until another character that is not an
"*" is found.
Users familiar with MS-DOS will be used to such conventions.
In AmigaDOS, the sequence of "#?" functions the same way as
the "*" does in DirUtil. (It is just a whole lot easier to
program the "*" pattern match!)
A few examples to help you out:
*.c matches all files that end in .c (du.c,test.c)
test? matches all files whose names are five characters long
(test1, test2)
*it* matches all files that begin with anything, have "it"
imbedded in the name, and end with anything. (editconfig,
go_for_it!)
The pattern matching formulas can handle multiple "*" and "?"
patterns. To enter the pattern, just append it to the name of
the disk in which you are interested. IE. if you want to
fetch the names of all the files in the subdirectory called
"stuff" on the disk called "dh0:" ending in ".info" you would
enter in either the "S" or "D" gadgets "dh0:stuff/*.info".
DO NOT enter the quotes. DirUtil will strip off the "/.info"
part since that is not really a part of the subdirectory and
Page 8
proceed to list matching files for you. If you elect to use
pattern matching, the pattern will appear with the name of
the disk on the top line of the DirUtil display. One more
example: list all files beginning with "amiga" in the root
directory of "df0:". To do this you would enter
"df0:amiga*". Note that you do not put the "/" character in
front of the pattern if you are at the root directory of a
disk.
REMINDER: One of the two windows on the DirUtil screen must
be active in order for any function that involves the RIGHT
mouse button to work properly.
ALL(D)
Select all files in the current "S" directory, including the
ones "scrolled off" the window. Clicking the RIGHT mouse
button will highlight all subdirectories as well. Clicking
the RIGHT mouse button while holding a SHIFT key will
highlight all files whose protection flag includes the
archive flag.
CLEAR
De-select all selected files in the "S" directory. Clicking
the RIGHT mouse button will clear all selected subdir-
ectories.
COPY
Copy selected files to the directory specified in the "D"
gadget. "D" must contain an existing directory path and CAN
go across devices. COPY preserves the protection status,
file comment, and creation date of the original file when
making the copy. DirUtil will clear the archive bit on any
copied file as per AmigaDOS convention. If you select to
copy a subdirectory, DirUtil will create that directory on
the "D" disk and copy all the files to the new directory. If
an error condition is encountered while copying files inside
the subdirectory or anywhere else in its particular "tree",
all files associated with the subdirectory will be deleted
from the destination disk. Clicking the RIGHT mouse button
on COPY copies all selected files as above and sets the
archive bit for the original file. Non disk devices such as
PRT:, SER:, and PAR: may have files copied to them by
manually entering the name of the device into the "D" gadget.
DELETE
Delete selected files and directories. You will be prompted
for confirmation before any files are deleted.
RENAME
Renames selected files to a different name or path (on the
same device). You must enter the COMPLETE PATH and NAME of
the renamed file. You will be prompted for the new filename
once for every highlighted file. If you enter an incomplete
filename path, DirUtil will attempt to rename the file based
on the current directory that was in effect when the program
was started.
MAKEDIR
Page 9
This will create a new subdirectory. You will be prompted
for the name of the new subdirectory. Enter the FULL PATH of
the directory you wish to create. DirUtil will prompt you
with the current "S" directory as a starting point to try and
save you some typing. Clicking the RIGHT mouse button will
create a directory AND create a drawer icon to go with it.
Also, using the RIGHT mouse button option will allow you to
create a drawer icon for an existing directory.
PARENT
Go to the parent directory of the "S" gadget. Clicking on
the gadget with the RIGHT mouse button will go to the parent
directory of the "D" gadget.
TYPE
Use this to view standard ASCII files on your screen. Use
the slider gadget to move anywhere in the text instantly.
Clicking the LEFT mouse button moves back a page. Clicking
the RIGHT mouse button moves forward a page. Cursor LEFT and
RIGHT emulate the LEFT and RIGHT mouse buttons. Cursor UP
and DOWN pages four lines at a time either up or down.
Hitting "T" will go to the top of a file and "B" key goes to
the bottom of a file. Hit the CLOSE WINDOW gadget or the ESC
key when you are through looking at the file. Clicking the
RIGHT mouse button on the gadget will type a file to the
screen in HEX and ASCII 20 numbers at a time. The mouse
pages the file as above and the cursor left, cursor right and
ESC keys also function as above. If you have trouble reading
the text displayed in the interlace mode, try dropping into
non-interlace mode before clicking TYPE.
INFO
Used to show the number of free bytes from the device
associated with the "S" gadget. Clicking the RIGHT mouse
button on this gadget will display the same data for the "D"
gadget. The numbers given in parentheses are the number of
disk sectors used and free respectively and can generally be
compared to the corresponding numbers given by the BYTE
command. INFO will also print the current status of the disk
in the drive, either READ-ONLY, READ-WRITE, or VALIDATING and
whether the drive is operating under AmigaDOS 1.2 format or
Fast File System format. Comparing the numbers INFO gives
for FFS and non-FFS devices is not very useful due to varying
data block sizes.
PRINT
Copies the chosen files and all files within chosen subdi-
rectories to PRT: using the current Preferences settings.
Clicking the RIGHT mouse button on PRINT will perform the
same function, but will print a formfeed character after
every file is printed.
SWAP
Flips the highlighted status of all files in the "S" di-
rectory, including subdirectories. Clicking the RIGHT mouse
button will copy DirUtil's file list information from the "S"
file window to the "D" file window WITHOUT actually copying
any files. This effectively gives you two windows that
Page 10
contain the same information without having to re-read the
disk's directory over again.
BYTE
Adds up the number of bytes of the selected files, sub-
directories and any files in the subdirectories and displays
the sum, the number of files, and the number of subdi-
rectories. The number in parentheses is the number of disk
sectors used by the files and subdirectories and can gen-
erally be compared to the corresponding numbers given by the
INFO command.
RUN
"RUNS" the selected files from inside DirUtil. The file
C:RUN must be available for RUN to function properly. If you
only have one disk drive or you do not want to be bothered
with having to reinsert the system disk to load the AmigaDOS
"run" command, add the following lines to your startup-
sequence and only run DirUtil from the CLI:
copy c:run ram:
copy c:cd ram:
path add sys:c
assign c: ram:
This batch file will, however, fail to find the normal DOS
commands if the system disk is not in the drive when the command
is invoked. Clicking this gadget with the RIGHT mouse button
will EXEC a batch file. The files "NEWCLI" and "ENDCLI" must be
available in your search path for EXEC to function. If the batch
file aborts, you will have to type "ENDCLI" to close the DOS
window. As a useful side effect to this abnormally ended batch
file, if you need a quick NEWCLI, just EXEC a file that is NOT a
batch file. EXEC will abort, but you will have a newcli and you
will not have to waste a user gadget on the command!
EDITOR
Call the program defined by the "Editor" gadget in EDITCONFIG in
order to edit the selected files. The editor is a completely
separate task and runs independently of DirUtil once started.
Clicking the RIGHT mouse button will call "ED" and put quotes
around the filename to be edited. Many editors cannot parse
quotes; this alternate format is a last resort when trying to
edit files which contain spaces in their filenames. Since the
editor runs as a separate task, the file length of the edited
file may not match the number displayed by DirUtil. All commands
will adopt the new file size if the edited file is accessed
again.
LIST
LIST will print the names, sizes, dates of creation and pro-
tection status of ALL files in the filelist. You will be
prompted for an output filename. This filename can be any
AmigaDOS device including the printer. If the output file
already exists, LIST will append its data to the end of the
existing file. LIST outputs its data in the same order as the
currently selected sort order.
Page 11
DATE
DATE is a multi-functioned toggle. If DATE is clicked with the
left mouse button, the file window's display will cycle between
several different combinations of information containing, in
sequence, the filesize, the file date and size, the file pro-
tection status and the file protection and date. Holding a SHIFT
key while clicking DATE will cycle the display in reverse order.
Clicking the RIGHT mouse button on DATE will check all the files
in the "S" directory against all files in the "D" directory and
highlight all those that are newer than a file of the same name
found in the "D" directory.
PROTECT
PROTECT summons a requester containing ten gadgets. Eight of
these gadgets are the alphabetic flags associated with the
protection status of a selected file. Click on these gadgets
until you have the pattern you wish to use for all the high-
lighted files. Clicking OK will protect the file according to
your pattern. Clicking ABORT leaves the pattern as it was before
the requester was entered. Subdirectories are treated like a
file, but you be asked if you wish to have all the files inside
the subdirectory set to the same pattern.
MOVE
MOVE performs a COPY and DELETE on the selected file(s) from the
"S" directory to the "D" directory. MOVE will move whole sub-
directories to any other path including another subdirectory or
another device. MOVE is the recommended way to get a file from
one place to another quickly since it will do a RENAME command if
the files are destined to be on the same device rather than copy
then delete a file. Successful MOVES between different devices
will result in the original file being deleted.
BEWARE: there is a bug in the DOS 1.2 RAM: device. You should
not MOVE a file to RAM: if it already exists.
SEARCH
Search a file for a pattern. You will be prompted for the search
string. Upper/lowercase characters are different ONLY if you
select this function with the RIGHT mouse button. If the "\"
character is found in the search string, the next two characters
are converted into a single hexadecimal digit and used as one
character in the overall search. If a question mark is found in
the pattern, it will match any character found in that position.
The search pattern is limited to 60 characters. SEARCH will
abort if you hit the close window gadget on its output window
while the search is in progress. When searching a file using a
hexadecimal pattern, it is recommended that you only use the
RIGHT mouse button option to prevent unwanted upper/lowercase
conversions.
DISKCOPY
COPY a whole disk without regard to file structure. You can copy
with one drive or two and can copy using the 5.25" Transformer
drive. DISKCOPY will prompt for a source and destination drive.
In the case of one drive copies, you will be prompted when disk
swaps are needed. Click the DirUtil window's close window gadget
in the upper left corner of the screen when you have swapped
Page 12
disks. DISKCOPY works ONLY with the floppy drives listed in the
prompt requester. DISKCOPY assumes you are copying disks with
the same number of cylinders ie. 3.5" to 3.5" or 5.25" to 5.25",
but not 3.5" to 5.25". Clicking the RIGHT mouse button on this
gadget will perform a DISKCOPY and verify the written data more
stringently. DISKCOPY does not require that the destination disk
be pre-formatted, it will do that itself if needed. DISKCOPY
uses all available RAM starting with FAST RAM and continuing with
CHIP RAM if needed. If you have enough free RAM to load the
entire contents of the disk into memory at one time, DirUtil will
ask you if you wish to make another copy of the disk after the
first copy is complete. If you tell DirUtil you would like
another copy, it will prompt you to insert another blank disk
(formatted or unformatted) into the drive that was specified as
the destination and click the
close gadget on the larger of the two DirUtil windows. You may
make as many copies of the same disk as you would like, just hit
"ABORT" when you wish to stop making copies.
LISTCOMP
List the contents of an ARC, ZOO or ZIP file to the screen. Hit
the Window Close gadget to exit from the listing window.
FIXOBJ
FIXOBJ will "pad" a file you have downloaded to enable the Amiga
scatter loader to process it correctly. FIXOBJ has two modes of
operation. First, if the file is NOT already padded and is an
executable, FIXOBJ pads it so that upon uploading, anyone
downloading that file need not FIXOBJ it again, just load and
run. Second, FIXOBJ will pad a file that has been downloaded but
not yet fixed. FIXOBJ will not pad any file that is not a stand
alone executable ie. ARC files. Clicking the RIGHT mouse button
on this gadget will change the dates of the highlighted files to
the current date. This is to fix a bug in some device handlers
and will not be needed using floppies, RAM: or hard disks with
properly written drivers.
SAVE OLD
SAVE OLD is a toggle. If enabled, you cannot copy/move/rename a
file to a file that already exists in the new directory path with
the same name. Clicking the RIGHT mouse button will highlight
all the files that exist on both the "S" and "D" devices.
FREEZE
FREEZE is a toggle. If FREEZE mode is active, any name you
highlight will not be de-selected upon completion of subsequent
functions that act upon highlighted files.
SHOW
SHOW the selected files as IFF pictures. If you have selected a
subdirectory, DirUtil will also show any pictures contained
within these subdirectories. Click in the upper left hand corner
of the screen or hit the ESC key to cease viewing a picture. If
the selected pictures have color cycling information imbedded in
them in Dpaint format, the picture will cycle automatically by
clicking the RIGHT mouse button on SHOW. DirUtil will reject any
file that is not a picture. It will also attempt to show a
picture recorded in "overscan" mode. Overscan mode is very
Page 13
desirable in professional video, but many monitors cannot display
the full picture at one time. If this is the case on your
monitor, use the left, right, up, and down cursor keys to move
the picture around on the monitor. I have purposely left out
bounds checking for this scrolling picture feature to enable the
largest possible pictures to be shown. If you scroll the picture
too far in a given direction, the Amiga will show it in a manner
not conducive to pleasant display. No harm will result, but the
picture will not look like a picture! To correct a situation
such as this, just scroll in the opposite direction and the
strange display mode will correct itself or hit the ESC key to
get out of SHOW mode and try again.
SLIDE
SLIDE is a toggle. The slideshow mode will show all selected
pictures with a blank backdrop screen. You do not have to click
in the upper left hand corner to view the next picture. When
starting the slide show, you will be prompted for the delay
factor between pictures. There are 50 time units per second ie.
entering 50 (the default) will pause one second between pictures.
The normal abort procedure for DirUtil functions still holds:
just click the black backdrop screen to the back and click inside
one of DirUtil's window as usual. Clicking the RIGHT mouse
button on SLIDE will toggle a continuous SHOW mode that will show
the selected files and directories until DirUtil is manually
aborted.
CHANGE
Perform a DISKCHANGE command on a floppy drive. You will be
prompted for the drive name. Clicking the RIGHT mouse button on
CHANGE will change the state of DirUtil. This state change
causes DirUtil III Plus Hr to free all the memory it can by
closing its screen and shrinking to a small window on the
Workbench named "DU3+HR". You may bring the program back by
clicking the RIGHT mouse button on this window.
FORMAT
FORMAT a floppy drive. You will be prompted for both the drive
name to format and the new name for the disk. Disknames must be
less than 32 characters in length. Format destroys all previous
data on a disk so be careful when using it. Format works on 3.5"
drives and the 5.25" Transformer drive. Clicking the RIGHT mouse
button will format the disk and do a more complete verification
of the disk at the same time. Either method of formatting a disk
is faster than the standard AmigaDOS format command.
RELABEL
Change the name of the disk represented in the "S" gadget. You
will be prompted for the new diskname. Names must be less than
32 characters in length.
COMMENT
Set the comment field of the selected files. You will be
prompted for the new comment to attach to each selected file in
succession. You must use the AmigaDOS LIST command or the
WorkBench INFO command to see the comment from outside DirUtil.
The COPY command will replicate the comment on any file you copy
unlike normal AmigaDOS (upto V1.2) and is the preferred way to
Page 14
preserve comments on a file. Clicking the RIGHT mouse button on
COMMENT will show the comments attached to the highlighted files
if one exists and prompt you before displaying the next comment.
CRYPT
CRYPT is a toggle. If lit, any file you TYPE, COPY, MOVE or SHOW
will be crypted/de-crypted according to the current password key.
To enter this password key, hit the RIGHT mouse button on CRYPT.
The decryption password must be at least 5 characters long. If
the CRYPT gadget is lit, this password will be used for various
commands listed below. DirUtil encodes 33.5 kilobytes of data
per second so using this function will not slow down operation
significantly. The encryption mode is reversible; ie. copying a
file twice with data encryption turned on will result in an
unchanged copy of the original file. No encryption algorithm is
foolproof, but the one used in DirUtil is as good as you will see
outside the government. Without the password, no one (even the
author) will have any kind of reasonable change of gaining access
to the file's data.
WHEREIS
WHEREIS is used to find a file on a disk when you only know the
first few letters of the name or are searching for any file that
contains a certain pattern. You will be prompted for the
filename which you wish to find. Enter as many characters as you
can remember (upper/lower case are the same). WHEREIS will scan
from the current "S" directory through all the files and sub-
directories on the disk looking for a match. For example, if you
entered "du", DirUtil will locate "du", "dudemo", "du3.cfg", etc.
If DirUtil finds a match, it will print the full pathname where
the file or subdirectory may be found and ask you if it should
continue searching. Any group of characters may be searched for,
although searching for a file with no name will not succeed.
WHEREIS has the same pattern matching capability as the rest of
DirUtil. IE searching for "du*" will produce the same results as
the above example. In fact, if you do not specify a pattern for
WHEREIS, it automatically adds the "*" character to the end of
your search string.
SORT
Clicking on SORT with the left mouse button rotates the current
sorting criteria of the file listings. The three possibilities
are: SORT by NAME (the default), SORT by DATE, and SORT by SIZE.
The new status of the file listing will be immediately re-
displayed according to the new settings. Clicking the RIGHT
mouse button on SORT toggles the sort routine's ascending-
/descending progression. The default is to sort in ascending
order. Files with bad datestamps will be set to have a date of
0, IE Jan 0, 1978 in the Amiga scheme of things. By definition
subdirectories have not a file length, so they are treated as
files with a length of 0. Observe that this allows all the
subdirectories of a disk to be grouped at the top or bottom of a
file listing if sorting by size is performed.
Page 15
PLAY
PLAY an IFF sound file or a raw data file or all the sound files
in a particular directory. If the file has a valid IFF header,
the period of the sound will be set accordingly. Clicking the
RIGHT mouse button on PLAY will cause the sound to play con-
tinuously until the user performs an abort. The default mode is
to play valid IFF sounds only. If the SHIFT key is depressed
while selecting play, you will be prompted to enter the number of
cycles per second to use in case a valid value cannot be obtained
from the file. The default value is 12000 and must be less than
65535.
COMPRESS
Compress will ask you which form of file compression you desire.
Click on either ARC, ZOO, ZIP, or PAK. (PAK is not currently
implemented). You will then be prompted for the name of the
compressed file to create. You must enter the WHOLE path and
name of the file to create WITHOUT THE EXTENSION that the file
compress program normally adds, IE .ARC, .ZOO, etc. The comp-
ression program will be loaded using the current path and name
setting of the appropriate parameter in the du3.cfg file.
Clicking the RIGHT mouse button on COMPRESS will UNCOMPRESS the
selected files. UNCOMPRESS automatically loads the correct
uncompression utility. You will be prompted for the device
and/or subdirectory into which the uncompressed files are to be
placed. The default is the "D" directory. If you change this
default, it must be changed to a device or subdirectory that
already exists. If you specify a name for the output directory
that does not exist, DirUtil will automatically make that
directory for you if possible. If you hit the RIGHT mouse button
on UNCOMPRESS with either SHIFT key pressed, DirUtil will create
a separate subdirectory for each file that it is asked to
uncompress. The subdirectory's name will consist of the name of
the original ARC file with the last character replaced by the
letter "D". UNARC will overwrite any file by the same name that
previously existed in the output directory. Both COMPRESS and
UNCOMPRESS open a console window on the screen to display their
progress. All external file compression commands require that
the file C:RUN be present on your disk. You may follow the
instructions listed under the RUN command to change this require-
ment.
EXAMPLES:
Given MYFILE.ARC here are all the ways to UNARC it and the
results:
Specifying "RAM:" for output --> All files in MYFILE.ARC end up
in root directory of RAM:.
Specifying "RAM:TEMP" for output --> Directory "TEMP" created in
RAM: if it does not exist, all files in MYFILE.ARC end up in the
TEMP subdirectory of the RAM: device.
Specifying "RAM:" for output when called with a SHIFT key pressed
--> Directory MYFILE.ARD created in "RAM:" and all files in
MYFILE.ARC end up in this subdirectory.
Page 16
Specifying "RAM:TEMP" for output when called with a SHIFT key
pressed --> Directory "TEMP" created in RAM: if it does not
exist, then subdirectory "MYFILE.ARD" created inside "TEMP" and
all files in MYFILE.ARC end up in "RAM:TEMP/MYFILE.ARD" sub-
directory.
USER GADGETS
These are completely user definable gadgets which perform various
functions depending on the definition string for a particular
gadget. To set a command string for any of these gadgets under
normal circumstances, hit the RIGHT mouse button on the gadget
and enter a string of the format NNNNNNNNMCCCCCCCCCCCCCCCCCC
where "N" represents the name to be displayed in place of the
default USER definition, "M" is a modifier or a normal letter
(see below), and "C" is the command string attached to this USER
gadget. A complete definition can be no more than 255 char-
acters. If the definition you are changing is already occupied
by a special device name (discussed below), you must press either
ALT key before clicking the RIGHT mouse button. A successful op-
eration will replace the old definition with the new one. The
next time you hit the LEFT button over the same gadget, the
command string will be interpreted depending on the modifier
used. If the "M" character in format string is not a "\" or "|",
the command string will be parsed (based on the commands below)
and the result sent to AmigaDOS for execution. If the modifier
is a "\", the command string is parsed (minus the "\") and sent
to AmigaDOS without the need to click on a filename. This form
is used for invoking frequently used external commands that may
require parameters, but not filenames. If the modifier is a "|",
the string of characters following, but not including, the "|",
are taken to be the new setting of the "S" gadget and the
appropriate directory will be read. Any USER gadget containing
the "|" modifier will behave just like its counterpart on the top
two rows of gadgets ie. clicking the RIGHT mouse button on the
gadget will set the "D" gadget to the drive/path associated with
it. For full compatibility with all DOS and NON-DOS commands,
DirUtil uses the AmigaDOS RUN command when executing any USER
gadget with the exception of the special "|" modifier above. The
file called "mydu3.cfg" included with this package is a working
example of a configuration file. If you wish to use this file,
copy your original "du3.cfg" file to a safe place, then copy
"mydu3.cfg" into your S: directory and rename it to "du3.cfg".
The parser looks for a % character followed by one of the
following characters:
"S" refers to the current "S" directory.
"D" refers to the current "D" directory.
"F" refers to the full path and filename of a highlighted
file.
"N" refers to the filename of a highlighted file excluding
the path name.
"E" refers to a parameter that you will be prompted for
during the execution of the user definition (entered
only once at the beginning of a multi-file operation
unless %R is encountered).
"C" refers to the hexadecimal address of the DirUtil screen
for use in the CONMAN program.
Page 17
"Bn" this character does not generate any text, but tells
DirUtil to move its screen to another location. If the
character represented by "n" is a "0", DirUtil's screen
will immediately move to the back of all other screens.
If the character is a "1", the DirUtil screen will move
to the front of all other screens. This command is used
primarily in conjunction with the "W" command listed
below.
"U" causes DirUtil to immediately update the file lists in
the "S" and "D" windows if needed. This command is used
primarily in conjunction with the "W" command listed
below.
"Wn" causes DirUtil to WAIT on a specific condition. Cur-
rently only one option is defined. If "n" is "0",
DirUtil will wait until a window on the WorkBench Screen
with a given name is closed. DirUtil will interpret the
characters that follow the "0" in the following pattern:
nnnnnnnnnn|wwwwwwwwww|.
Example:
%w0testingwindow|%b1%u|
This will cause DirUtil to complete the other commands
contained in the user defined gadget, then wait until a
window title whose first characters are "testingwindow"
(no quotes, upper/lower case ARE SIGNIFICANT), has
closed. When this condition is met, DirUtil will
execute the commands "%b1%u" (also no quotes) which will
bring the program's screen to the front and update the
file listings. The wait commands are designed to be
able to let DirUtil interact better with external
programs that may be launched from within the program.
If you spell the name of the window wrong, DirUtil will
appear to lockup, clicking the left button will bring up
the normal abort function requester as always. The
string that is to be executed after the wait is complete
is reinterpreted from scratch based on the values that
were in place at the end of the initial operation that
started the wait. There may theoretically be %w
commands inside other %w commands although this has not
been tested. IMPORTANT NOTE: For maximum flexibility,
DirUtil runs programs assigned to the USER GADGETS as
synchronous tasks under AmigaDOS. This means that
DirUtil will not continue until the other program has
finished running. This causes a problem when asking
DirUtil to wait on the opening and closing of a window
since it will never get a change to look at the state of
the WorkBench screen with the other program in op-
eration. Therefore, when using this option, please add
the run command to the start of any program that is run
from inside DirUtil.
"R" resets the flag and allows a user to subsequently enter
new text at a %E prompt. This allows for multiple user
inputs in the same user definition.
"P" Sets the prompt string for use by the %E command. %P
should occur before the %E command it is to affect. The
Page 18
string should end with a | character and be no more than
30 characters long.
"%" Use a real percent sign instead of interpreting it as a
command introduction. IE if you want a % in your user
text, type %% instead.
"I" If interlace mode is not already active, turn it on.
"L" If interlace mode is already active, turn it off.
"Z" Stands for ZAP devices. It will clear all device def-
initions from the first eight device gadgets as well as
any overflow that has been stored in the user definable
area. It will then scan the list of current file system
devices and fill in the appropriate gadget boxes with
your current device list. DirUtil will handle a removed
device (as of Workbench 1.3).
EXAMPLE:
-------
The "S" directory is "df0:s" and you have highlighted the
file "startup-sequence". The "D" directory is "df1:backups".
The definition string for one of the user gadgets looks like:
"MAKEBAK copy %f to %d/%n.bak"
1 9
^ ^
|-------|
|
- Note the positions of the characters in the string
gadget.
The quotes in the above definition ARE NOT TO BE TYPED, they
are for delineation only. If you were to click on this user
gadget, DirUtil will interpret and send the following command
to AmigaDOS:
"copy df0:s/startup-sequence to df1:backups/startup-
sequence.bak"
Notice the "/" character in the definition in between the %d
and %n commands. This is required to make a valid path name.
The carriage return between "startup-" and "sequence" is
caused by my word processor and should not be typed. The
included config file shows many of the ways to use the
parser.
EXAMPLE 2:
---------
A user gadget definition looks as follows:
" PKAX %pEnter Output Dir|run > nil: cd %e+<CR>pkax %f"
This definition will set the prompt for the %E command to
"Enter Output Dir", prompt for a string, then use the +
option of the RUN command to run two commands in sequence.
The <CR> symbol means to type a CTRL-J in its place. This is
the way AmigaDOS recognizes a carriage return in a manner
equivalent to typing it from the keyboard. The first command
will CD to the string just entered ie. the disk or sub-
Page 19
directory where you wish the files to be unARCed into. After
CD runs, the file named PKAX will be run with the filename
and path currently being processed. This is basically the
way that DirUtil does an UNARC command using the built-it
gadget.
IMPORTANT:
---------
When DirUtil first boots, it will look in your S: directory
for a file called "du3.cfg". This file MUST exist. The USER
gadgets will be preloaded with the file's contents. On
leaving DirUtil, if you have changed any of DirUtil's
defaults, it will ask you if you wish to save the new config
file.
HINT:
----
You can use the AmigaDOS Execute command to run a batch file
using a user gadget. This will allow more flexibility when
creating your user definitions by allowing parameters to be
passed to the batch file for conditional testing.
Page 20
IMPORTANT OPERATIONAL NOTES:
---------------------------
There are no known conditions that will crash DirUtil. If you get
a software failure during use, be sure that the error is not
caused by another task running at the same time. When all else
fails, AND you can replicate the error using DirUtil AND provide
an exact command sequence that produces the error, let me know and
I will fix the bug. I have gone to great lengths to provide low
memory and stack error checking, however if you get sporadic guru
meditations during usage of DirUtil, or you have a hard drive, I
recommend you increase your stack size slightly from the Workbench
supplied default of 4000 and try to run DirUtil again.
DirUtil has a limit of 255 characters for directory path names.
This is based on the length of a command line in the AmigaDOS CLI
environment.
While you are using DirUtil, various prompts will come up asking
for confirmation. There will be two selections: "CONTINUE" or
"ABORT". "CONTINUE" is always the affirmative to the prompt and
"ABORT" is the negative response. The most common requestor you
will get when calling external programs such as ARC or ZOO is the
"UPDATE FILELIST" requestor. Getting this requester, means that
DirUtil has detected that the filelist in memory is not current
for one reason or another. If re-reading the filelist would
disturb your current set of file selections, DirUtil will ask you
if you want to update the filelist. If you have no files and/or
subdirectories selected from the filelist that needs updating,
DirUtil will update the listing automatically.
AmigaDOS, and consequently DirUtil, has problems with spaces in
file and volume names. This problem will result in unexpected
results when using some external commands from within DirUtil.
DirUtil tries to minimize this problem by putting quotes around
commands with spaces in them, but not all programs can parse
quotes in the way AmigaDOS handles them. Also, DirUtil uses the
volume name of a disk rather than its device specification for
most operations. Consequently, disks with the same volume name
mounted at the same time tend to produce unpredictable results.
The DISKCOPY command of DirUtil assumes it is copying a normal
AmigaDOS disk. However, DirUtil will copy any non-copy protected
disk non-AmigaDOS disk. If a non-AmigaDOS disk is detected,
DirUtil will not update the creation date on the destination disk,
thus making an exact copy of the original.
DirUtil was developed and tested on an Amiga 1000 with 2 3.5"
drives, 1 5.25" Transformer drive, 1 5.25" 880K Quad Density drive
(emulating a 3.5" drive), 2.5 Megabytes of RAM and 2 50 meg C-Ltd
SCSI hard drives. DirUtil has also been tested on the Amiga 500
with and without the A501 RAM Expander, and on an Amiga 2000 with
and without RAM expansion and hard disk. This implies that some
users may find it difficult to use DirUtil on a machine with only
one drive. DirUtil has been tested under these conditions and
performs quite well although disk swapping will cause irritation
when using external commands. It is also not recommended that you
invoke ARC, UNARC, ZOO, or UNZOO with only one drive (don't forget
Page 21
the RAM: drive however). Also, in order to provide the best
possible throughput, DirUtil buffers a whole picture in ram while
it is being decoded for showing. This buffering may cause
problems when showing some pictures on a 512K machine if memory
has become fragmented.
Page 22
Quick Reference Chart for DirUtil
GADGET LEFT BUTTON RIGHT BUTTON R/SHIFTED
------------------------------------------------------------
EIGHT "S" = Drive "D" = Drive
DEVICE in gadget in gadget
GADGETS
ALL(D) Mark ALL files Mark ALL files/subdirs Mark ALL archive
INFO "S" info "D" info
PARENT "S" parent "D" parent
PROTECT Protect Files
CLEAR Unmark files Unmark subdirs
SWAP Swap "S" & "D" Copy "S" TO "D"
TYPE Type in ASCII Type in HEX/ASCII
RUN AmigaDOS RUN AmigaDOS Script RUN
COPY Copy Files Copy Files w/Archive
MOVE Move Files
PRINT Print Files Print files w/Formfeed
DELETE Delete files
FORMAT Format Floppy Format w/VERIFY
MAKEDIR Create subdir Create subdir w/ICON
RENAME Rename files
DISKCOPY Diskcopy Floppy Diskcopy w/VERIFY
LIST List to file
SEARCH Files W/UL CASE Files w/ U <> L Case
EDITOR Edit files Edit files + quotes
BYTE Files/dir Sizes Compare File Sizes
FIXOBJ Pad Files Fix Invalid File Date
CHANGE Diskchange dfx: Change DU3+HR state
LISTCOMP List comp.File
RELABEL Volume "S" Name Volume "D" Name
SORT Date/Name/Size Ascending/Descending
PLAY Play a File Play continuously Play Non IFF
COMPRESS Make ZOO/ARC UNCOMP a file UNCOMP w/subdirs
COMMENT Set File Comment Print File Comments
SHOW SHOW W/O CYCLE SHOW W/CYCLE
WHEREIS Find a file
CRYPT+ Use Encrypter Set Encrypt Key
DATE+ Show File Attrib Compare File Dates
FREEZE+ File selection
SAVE OLD+ Overwrite Files? Check for Existence
SLIDE+ Slideshow mode Show files continuously
USER** Invoke USER Set USER
** ALT KEY REQUIRED TO SET SOME FUNCTIONS
+ FUNCTIONS AS TOGGLE
VERSION NUMBER IS SHOWN BY CTRL-ALT-SHIFT
INTERLACE TOGGLED VIA SHIFT-ESC
ICONIFY Activated VIA CTRL-ESC, Deactivated by RIGHT MButton
How to Use the Palette Program
The program named PAL on the DirUtil disk is used to change the
colors of the windows used to display file names and text files.
The program can only be run when DirUtil is already running. PAL
may be run from the Workbench using the icon provided or from the
CLI. PAL will only search out the frontmost DirUtil screen in
case you have multiple copies of the program running. You have
several options upon loading PAL. The upper third of the window
contains four squares each corresponding to one of the four colors
of the DirUtil screen. Clicking on any of these will set the RGB
sliders at the bottom of the window to the values that color
represents. You may change the color by sliding any of the three
gadgets on the bottom third of the screen. The colors will change
dynamically. PAL initially sets these sliders to the settings of
color 0 of the file window. There are six gadgets in the middle
third of the window. In order, they are FILE, RFIL, TEXT, RTXT,
SAVE, and QUIT. Clicking on FILE or TEXT will set the color
palette to the currently stored values for the selected set of
windows. Clicking on RFIL or RTXT will reset the color palette of
the corresponding window to the state it was in when PAL was
loaded. Clicking SAVE saves the new palette to the S:du3.cfg
file. Clicking QUIT exits PAL without saving. The colors shown
when TEXT is clicked upon are the ones used for the TYPE, HEX
TYPE, SEARCH, ARCV, and ZOOL commands. Please read the notes on
the next page for cautions when using any of the programs that can
change the config file. DirUtil is still running when the PAL
program is active and you can switch between all the various
displays until you have the colors set just right. You cannot
exit DirUtil, change its resolution, or iconify until the palette
program has terminated. If you change the palette colors and
select QUIT, DirUtil will use the new colors only until the
program has ended, at which time it will revert back to the
previously saved colors.
Page 24
How to Use the Configuration Editor
The program named EDITCONFIG on the DirUtil disk is used to change
certain runtime parameters that DirUtil needs to know when running
with your particular system. Currently, you can configure the
name of the text editor to use with the EDITOR command, the
commands to be called when ARC, UNARC, ZOO, and UNZOO are issued,
the default drive when a directory cannot be found, the name of
the temporary batch file to be used with the EXEC command, and
nine togglable switches for several of the program defaults. A
few notes are in order about the use of these gadgets.
Your text editor must be able to handle a filename on the command
line in the form: <name of editor> <filename>. The <name of
editor> field will be taken directly from your configuration file.
If you are using the Workbench to run DirUtil, you might consider
adding the full path name here in case Workbench cannot find the
editor in the C: directory.
The Default Drive is the name of the device and/or subdirectory to
go to if a filelist cannot be read from a user specified drive.
This drive MUST exist at all times or be loadable by AmigaDOS if
needed. If you choose to use the name of a subdirectory here, do
not add the trailing / character to your entry. This is also the
drive that DirUtil will default to if started from Workbench.
The Batch File name is strictly a temporary file used by DirUtil
when invoking the EXEC function. For speed, you might locate this
to your RAM or virtual disk. The filename is arbitrary in any
case as this file is deleted upon successful completion of an
EXEC.
The Zlist name is the name of the file that DirUtil III Plus HR
creates when making a ZOO file. It contains the names of the
files that ZOO is to process, including the contents of any
subdirectories. The filename is arbitrary in any case as this
file is deleted upon successful completion of a ZOO.
The rest of this section of the configuration program consists of
the names and arguments to the ARC/ZOO/ZIP/PAK type commands. The
only two rules here are:
1. Whatever your command, it MUST NOT expect user input
at any time. The supplied default configuration file
adheres to this requirement by making use of ARC and
ZOO's ability to automatically overwrite existing files
to prevent this question from being asked of the user.
ARC, ZOO, and PKAX all work fine for uncompressing a
file (use the -r option on PKAX).
2. Because DirUtil uses AmigaDOS I/O redirection, it
must place a command string just after the name of the
command to be issued. It does this by inserting its
command string just after the first space encountered in
the command you have entered in your configuration file.
For example: "Arc a" in the "ARC" gadget of
EDITCONFIG's window would result in "Arc (some internal
stuff) a" being the first part of the command line
Page 25
actually sent to AmigaDOS. The only real limitation
here is that you cannot use spaces in the filename that
invokes your command since that would cause DirUtil to
insert its text in the wrong place. This text insertion
is only done for the file compress/uncompress commands.
There are three rows of four togglable gadgets just below the
string gadgets. In order they are:
SHOWPAR? If highlighted, DirUtil will add the AmigaDOS
PAR: and SER: devices to your device list.
AUTOREF? If highlighted, DirUtil will automatically
update the "D" filelist with the one in the "S" filelist
if a command causes a change in the contents of the "S"
filelist, and the name in "D" is the same as the name in
"S".
TYPE200? If highlighted, DirUtil will switch to non-
interlaced mode while using the color palette that you
see while displaying files in ASCII or HEX.
CRYPT, FREEZE, SAVE OLD, SLIDE These are the startup
defaults for the corresponding gadgets inside DirUtil.
HIDEFILE If highlighted, all files marked as HIDDEN by
AmigaDOS will not show up in any file listings.
UNUSED1,2,3 Reserved for future expansion.
In the current version of EDITCONFIG and the DirUtil main program,
all the configuration information is stored in one file called
"S:du3.cfg". If you do not have this file available when either
EDITCONFIG or DirUtil is loaded, it will abort. Also, neither the
main program, PAL, or EDITCONFIG know if the contents on this file
have been changed by any of the other programs. Make sure that
your only use one program at a time if you are going to save your
configuration. DirUtil itself only saves this file if you have
changed the definition of one of the user gadgets, the resolution
of the screen, or the position or size of the function window on
the screen, You will be asked if you wish to save the new config-
uration upon exiting the program.
Page 26
How to Use the CONVERT program
The CONVERT program should only be used if you purchased DirUtil
III Plus HR and that version of the program stores its config-
uration information in a file called "du2.config". CONVERT will
process this file and output the "S:du3.cfg" file that DirUtil
requires for operation. Also, if you have a "du2.color" file,
CONVERT will process it at the same time.
Page 27
